home *** CD-ROM | disk | FTP | other *** search
/ Gekikoh Dennoh Club 1 / Gekikoh Dennoh Club Vol. 1 (Japan).7z / Gekikoh Dennoh Club Vol. 1 (Japan) (Track 1).bin / kowin / archive / sys / kowin14d.lzh / doc / library / gviewlib.man < prev    next >
Text File  |  1995-09-02  |  4KB  |  97 lines
  1.  
  2.     X680x0 Ko-Window 用ライブラリ
  3.     gvlib.a  関数マニュアル
  4.                     Copyright 1995 小笠原博之(COR.)
  5.  
  6.  
  7. 0. はじめに
  8.  
  9.   このライブラリは、グラフィック画像をウィンドウに表示するためのライブラリで
  10. す。このライブラリを使う時は gviewlib.h をインクルードして下さい。
  11.  
  12.  
  13.  
  14. 1. GView ウィンドウ関数
  15.  
  16. void    GViewOpen( x, y, gp, title, mode )
  17. ----------------------------------------------------------------------------
  18. int    x, y;        ウィンドウ表示位置
  19. GVIEW    *gp;        構造体
  20. int    mode;        タイトルバーに出るボックス
  21.  
  22.   x, y の位置に gp->h, gp->v サイズの GView ウィンドウをオープンします。title
  23.   はウィンドウのタイトル文字列です。あらかじめ gp 構造体に必要な情報を設定し
  24.   てから呼び出さなければなりません。
  25. ----------------------------------------------------------------------------
  26.  
  27. void    GViewRedraw( gp, mode )
  28. ----------------------------------------------------------------------------
  29. GVIEW    *gp;        構造体
  30. int    mode;        描画内容
  31.  
  32.   ウィンドウを再描画します。mode が TRUE の時は、ウィンドウ内部のクリアを含
  33.   めた再描画を行います。FALSE の時は、グラフィックの転送のみ行います。例えば
  34.   すでに画像を表示してウィンドウを開いている場合、バッファのグラフィックデー
  35.   タを変更した場合は、mode == FALSE で呼び出すことで画像のみ更新することがで
  36.   きます。この関数はパレットの再設定を行います。
  37. ----------------------------------------------------------------------------
  38.  
  39. void    GViewSetPalet( gp )
  40. ----------------------------------------------------------------------------
  41. GVIEW    *gp;        構造体
  42.  
  43.   パレットの再設定を行います。画像が65536色モードの時は何もしません。
  44. ----------------------------------------------------------------------------
  45.  
  46. GVIEW    *GViewAlloc( h, v, color, work )
  47. ----------------------------------------------------------------------------
  48. int    h;        画像サイズ
  49. int    v;        画像サイズ
  50. int    color;        色モード(WindowAttrGraphic16/256/65536のどれか)
  51. int    work;        余分に確保するサイズ(通常は0でよい)
  52.  
  53.   引数の値から必要なメモリ容量を計算し、GVIEW 構造体および画像を格納するため
  54.   のバッファをまとめて MALLOC します。DOS MALLOC を使うため、この関数で得ら
  55.   れたメモリは、そのアプリが必ず責任を持って開放しなければなりません。得られ
  56.   た gp には、gp->h, gp->v, gp->color にそれぞれ引数で指定した値が、gp->buf,
  57.   gp->palet には確保したメモリの割り当てられたアドレス、が入ります。
  58.   work はメモリを余分に確保する場合の容量です。(例えばファイル名を一緒に格納
  59.   しておきたい場合等) work 分のメモリポインタのアドレスは、gp->EventExec に
  60.   入ります。メモリが確保できないときは NULL を返します。なお、gviewlib でメ
  61.   モリを確保する場合必ずこの関数を使わなければならない、というわけではありま
  62.   せん。(必須ではない)
  63. ----------------------------------------------------------------------------
  64.  
  65.  
  66.  
  67.  
  68. 2. GVIEW 構造体
  69.  
  70. ----------------------------------------------------------------------------
  71. typedef struct {
  72.     int        h,        /* 画像の横ドットサイズ */
  73.             v;        /* 画像の縦ドットサイズ */
  74.     int        color;        /* 色モード        */
  75.     unsigned short    *buf,        /* 画像データ        */
  76.             *palet;        /* パレットテーブル    */
  77.     int        flag;        /* スリープフラグ    */
  78.     int        (*EventExec)();    /* イベント処理関数    */
  79.     WindowID    wp;        /* ウィンドウ ID    */
  80. } GVIEW;
  81.  
  82. ・ユーザーが設定すべき項目
  83.     h,v    画像サイズ
  84.     color    色モード、WindowAttrGraphic16/256/65536 を代入します
  85.     buf    データの先頭アドレス
  86.     palet    パレットテーブルの先頭アドレス(パレットがない場合はNULL)
  87.     EventExec イベント処理関数。呼び出し時の引数は
  88.             (*EventExec)( WindowID, EventInfo*, GVIEW* );
  89.         呼び出すイベントは、EventClose, EventMouseSwitch, EventKey,
  90.         EventUser, EventIconify。
  91. ----------------------------------------------------------------------------
  92.  
  93.  
  94.  
  95. --
  96. 最終更新  1995 9/1  COR.
  97.